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SUMMARY 


! A set of improvements has been designed and implemented into a test version 
of the NASTRAN DMAP (Direct Matrix Abstraction Program) compiler. These modifi- 
cations simplify the use of the DMAP control language while enhancing its power 
|and versatility. The implemented changes are described and examples are pre- 
sented to illustrate their use. 


INTRODUCTION 


! Traditionally, the NASTRAN engineer-user has not felt comfortable with the 
iDMAP capability. Its style is oriented to the programmer. It uses complicated 
semantic constructs that are overly formalized. Also, its implementation re- 
tains many undesirable and confusing restrictions. 


Modifications have been made to the DMAP compiler to alleviate many of 
these disadvantages. Removal of certain restrictions has unlocked powers that 
have been imprisoned in the system since its inception. Full downward compat- 
ibility with currently operational DMAP has been retained. 


These changes fall into three overlapping categories: 

Improved Syntax 
Removal of Restrictions 
Extension of Capability 
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Improvements falling into the first two categories allow for the inadvertent 
introduction of errors into DMAP programs that previously would not be allowed. 
To protect the user, the extended capabilities include an err or -handling 
facility, and a new class of POTENTIALLY FATAL ERRORS is defined. Thus, the 
system protects users from costly errors arising from incorrect DMAP while 
allowing the user freedoms he could not otherwise enjoy. 


I 

i 
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IMPROVED SYNTAX 


Several cosmetic changes have been made by removing many of the semantic 
inconveniences. These syntax improvements include: 

1. Abbreviation of the parameter section to eliminate the redundant 
use of the C, V, and N specifications. For instance, the param- 
eter section of a DMAP instruction 

/C , N, 2/C , N, STATICS /V, N , NL0AD/V, N , PARM=1 . 0 
now may be written as 

/2/*STATICS*/NL0AD/PAKM=l . 0 


2. Allowing the use of default parameters not only at the end of 
the parameter section, but also internal to it 

/2/PARM=l. 0///4. 5//NL0AD 

3. Elimination of the need for trailing commas in both the input 
and output data block name lists when they are not required. 

TABPT EST,,,,// $ 


now may be written 


TABPT EST// $ 

4. An automated checkpoint option controlled by a "predefined 
checkpoint" (PRECHK) declaration has been Implemented. An 
analyst may generate all required checkpoint instructions by a 
single statement such as 

PRECHK A,B, C, D,F,X $ 

Even more convenient forms have been implemented, 

PRECHK ALL $ 

PRECHK ALL EXCEPT A,B,C $ 

This extension still allows the user to place the conventional 
CHKPNT instruction throughout his program. 


5. An automated SAVE specification to be included within the pararn 
eter section of the module instruction rather than a separate 
declaration. 


M0DX 
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SAVE 


A,B/C/V,N,P1/V,N,P2 $ 
P2 $ 


now may be written 


! M0DX A,B/C/P1/5,N,P2 $ 

The effects of (4) and (5) above are much more than superficial. When 
combined and used appropriately, they reduce the length of DMAP routines (i.e., 
[Rigid Format 1) by as much as 30%. 

This more concise code is superior in structure and is made more readable 
by eliminating many statements that are not essential to the solution flow. 

Such structure allows for more rapid understanding of the solution algorithm. 
The automatic SAVE prevents the accidental misplacement of the SAVE instruction 
that formerly caused a dump. Such a misplacement is now handled correctly and 
does not cause an abnormal termination. 

Though most of the above changes are cosmetic in nature, the improvements 
described next offer significantly improved capabilities. 


REMOVAL OF RESTRICTIONS 


| There are many capabilities intrinsically available via the DMAP language 
that cannot be exploited because of the arbitrary restrictions imposed by the 
I current DMAP compiler. The following changes have been made to remove these 
restrictions and greatly enhance the power of the language: 

1. Data blocks may now appear as input before they appear as output, 
j 2. Data blocks may now appear more than once as output. 

3. The REPT instruction has been modified to allow a variable number 
of loops to be determined during execution. This usage is 
exemplified by 

REPT L00PT0P , NL00P $ 

where NL00P is a parameter output by some module prior to the 
REPT instruction. 

4. The severely restrictive positional requirements of the EQUIV 
instruction have been eliminated. 

The removal of the first two restrictions and the addition of the 
variable REPT instruction opens new vistas for the DMAP user. In addition, 
change (2) allows locally used data block names to be reused later; thus the 
efficiency of file allocation within the NASTRAN system is increased. The 
positional requirements of the EQUIV module that have accounted for many con- 
fused hours of debugging have been eliminated. The single requirement is that 
the primary data block of the EQUIV instruction must appear as output prior 
to the EQUIV. 
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The DMAP user now has the tools with which to design and execute sophisti-i 
cated iterative algorithms. Such facilities have been long desired within the 
NASTRAN environment for solving complex nonlinear problems which involve either 
single or nested looping. , 


EXTENSION OF CAPABILITY 


New capabilities have been added that on the surface appear to be very 
simple, yet they have profound effects on the flexibility of file operations, 
on user understanding, and on program control. These are 

1. The implementation of two modules, C0PY and SWITCH. 

2. A new technique for user-specified compiler options, including a I 

detailed cross reference of data block names, module names, and 
variable parameter names, and a complete and detailed 0SCAR dump. j 

i 

3. Specification and control of the extended error-handling facility. j 

The C0PY and SWITCH modules are of great use in iterative DMAP routines. 
C0PY performs a complete physical copy from the specified input data block to 
the output data block. SWITCH operates directly on the FIAT (File Allocation 
Table) to interchange data block names. It does not copy data. 

The combination of these modules greatly simplifies and shortens DMAP 
looping. For example, in Figure 1, the DMAP code for raising a matrix [Q] to 
the rth power is shown in the original DMAP and again in the improved and ex- 
tended DMAP. The simplification that results is immediately apparent. 

Special compiler options may be elected, not through the DIAG, but by a 
new instruction XDMAP (Execute DMAP). Convenient options include: G0/N0G0 to 
allow a compilation only; LIST/N0LIST for DMAP compilation listing; DECK/N0DECK 
to request the punching of the DMAP program; REF/N0REF to provide a cross 
reference; and 0SCAR/N00SCAR to print a detailed listing of all 0SCAR records 
generated by the compiler. The 0SCAR (Operation Sequence Control ARray) is the 
"object" code that DMAP generates and is used to direct the actual computa- 
tional flow. Also activated by the XDMAP instruction is the extended error- 
handling facility described below. These features are easy to use and helpful 
to both programmers debugging DMAP programs and engineers/analysts having to 
write tneir Ow Li ruuLincs cr males local mod if ications to existing DMAP. 

The extended error-handling facility justifies the removal of restrictions 
and improvement of capabilities in that it assures the user that gross logic 
errors in DMAP programs will not be costly. This feature helps the user diag- 
nose and solve any problems caused by the new semantics. A new class of 
POTENTIALLY FATAL ERRORS warns the user to review his operations carefully* 

The user can select the error level (WARNING, POTENTIALLY FATAL, or FATAL) at 
which termination of the job will occur. Examples of XDMAP instructions are 
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XDMAP G0,LIST,ERR=3 $ 

I XDMAP N0G0, LIST, REF, 0SCAR,ERR=1 $ 

Figure 2 shows a composite illustration of the detailed cross reference, while 
Figure 3 is an excerpt from an 0SCAR listing. Both of these figures are derived 
from the Level 15.5 Rigid Format 1. 


CONCLUSION 


Changes have been designed and Implemented into the DMAP compiler that 
have improved the syntax and simplified DMAP usage for the engineer/analyst. 
Also, convenient mechanisms have been added to extend the file manipulation 
features. Finally, the removal of arbitrary compiler restructions has unlocked 
implicitly existing capabilities which greatly enhance the flexibility of the 
j language. 

i 
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OLD SYNTAX 


1 

BEGIN 

$ 


2 

MATPRN 



3 

PARAM 

// C,N,N0P / V , N , TRUE=-1 $ 


4 

PARAM 

// C,N,SUB / V,N,RR / V,Y,R=-1 

/ C,N,2 $ 

5 

PARAM 

// C,N,N0P / V,N,FALSE=+1 $ 


6 

C0ND 

ERR0R1.RR $ 


7 

ADD 

Q, / QQ $ 


8 

LABEL 

D0IT $ 


9 

EQUIV 

QQ,P / FALSE $ 


10 

MPYAD 

Q,QQ, / P / C.N.O $ 


11 

EQUIV 

P ,QQ / TRUE $ 


12 

PARAM 

// C , N , SUB / V,N,RR / V.N.RR / 

C,N,1 $ 

13 

C0ND 

ST0P.RR $ 


14 

REPT 

D0IT, 1000000 $ 


15 

JUMP 

ERR0R2 $ 


16 

LABEL 

ST0P $ 


17 

MATPRN 

P,,,, // $ 


18 

EXIT 

$ 


19 

LABEL 

ERR0R1 $ 


20 

PRTPARM 

// C.N.-l / C.N.DMAP $ 


21 

EXIT 

$ 


22 

LABEL 

ERR0R2 $ 


23 

PRTPARM 

// C,N,-2 / C,N,DMAP $ 


24 

EXIT 

$ 


25 

END 

$ 




NEW SYNTAX 



1 

BEGIN 

$ 

2 

MATPRN 

Q // $ 

3 

PARAM 

// *SUB* / RR / V,Y,R=-l/2 $ 

4 

C0ND 

ERR0R1, RR $ 

5 

C0PY 

Q / P $ 

6 

LABEL 

T0P $ 

7 

SWITCH 

P,QQ // $ 

8 

MPYAD 

Q,QQ / P / 0 $ 

9 

REPT 

T0P,RR $ 

10 

MATPRN 

P $ 

11 

EXIT 

$ 

12 

LABEL 

ERR0R1 $ 

13 

PRTPARM 

// -1 / *DMAP* $ 

14 

END 

$ 


Figure 1.- Raising a matrix Q to the power R. 
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Figure 2.- Composite illustration of the DMAP cross reference 
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